
<html><HEAD>
<LINK REL=STYLESHEET HREF="default.css" TYPE="text/css">
<TITLE>
Changing default layouts</TITLE>
</HEAD>
<BODY>

<!-- Header -->
<p class="ancestor" align="right"><A HREF="pbugp17.htm">Previous</A>&nbsp;&nbsp;<A HREF="pbugp19.htm" >Next</A>
<!-- End Header -->
<A NAME="CHDCFDEE"></A><h1>Changing default layouts</h1>
<A NAME="TI524"></A><p>You can change the layout of the PowerBuilder main window
in several ways. This section describes:<A NAME="TI525"></A>
<ul>
<li class=fi>Showing
or hiding the System Tree, Output, and Clip windows and changing
their locations</li>
<li class=ds>Showing or hiding views in painters and changing
their locations
</li>
</ul>
</p>
<A NAME="TI526"></A><p>You can also show or hide toolbars, change their locations,
and add custom buttons. See <A HREF="pbugp19.htm#X-REF342804801">"Using toolbars"</A>.</p>
<A NAME="TI527"></A><h2>Arranging the System Tree, Output, and Clip windows</h2>
<A NAME="TI528"></A><h4>Hiding windows</h4>
<A NAME="TI529"></A><p>The System Tree, Output, and Clip windows can all be hidden
at any time by clicking their buttons on the PowerBar. </p>
<A NAME="TI530"></A><h4>Moving windows</h4>
<A NAME="TI531"></A><p>You can dock the System Tree, Output, and Clip windows at
the top, bottom, left, or right of the PowerBuilder main window
by dragging the double bar at the top or side of the windows.</p>
<A NAME="TI532"></A><h4>Using the full width or height of the main window</h4>
<A NAME="TI533"></A><p>Windows docked at the top or bottom of the main window occupy
the full width of the frame. You can change this default by clearing
the Horizontal Dock Windows Dominate check box on the General page
System Options dialog box. The following screen shows the Clip and
Output windows docked at the bottom of the window. The Horizontal
Dock Windows Dominate check box has been cleared so that the System
Tree occupies the full height of the window:</p>
<br><img src="images/cust01.gif">
<A NAME="CAICIJHJ"></A><h2>Using views in painters</h2>
<A NAME="TI534"></A><p>Most of the PowerBuilder painters
have views. Each view provides a specific way of viewing or modifying
the object you are creating or a specific kind of information related
to that object. Having multiple views available in a painter window
means you can work on more than one task at a time. In the Window painter,
for example, you can select a control in the Layout view to modify
its properties, and double-click the control to edit its scripts.</p>
<A NAME="TI535"></A><p>Views are displayed in panes in the painter window. Some views
are stacked in a single pane. At the bottom of the pane there is
a tab for each view in the stack. Clicking the tab for a view pops
that view to the top of the stack. </p>
<A NAME="TI536"></A><p>Each painter has a default layout, but you can display the
views you choose in as many panes as you want to and save the layouts
you like to work with. For some painters, all available views are
included in the default layout; for others, only a few views are
included.</p>
<A NAME="TI537"></A><p>Each pane has:</p>
<A NAME="TI538"></A><p><A NAME="TI539"></A>
<ul>
<li class=fi>A title bar you can
display temporarily or permanently</li>
<li class=ds>A handle in the top-left corner you can use to drag
the pane to a new location</li>
<li class=ds>Splitter bars between the pane and each adjacent
pane
</li>
</ul>
</p>
<A NAME="CAIBECAI"></A><h3>Displaying the title bar</h3>
<A NAME="TI540"></A><p>For most views, a title
bar does not permanently display at the top of a pane because it
is often unnecessary, but you can display a title bar for any pane either
temporarily or permanently.</p>
<A NAME="TI541"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To display a title bar:</p>
<ol><li class=fi><p>Place the pointer on the splitter bar at
the top of the pane.</p><p>The title bar displays.</p></li>
<li class=ds><p>To display the title bar permanently, click the
pushpin at the left of the title bar or select Pinned from its pop-up
menu.</p><p>Click the pushpin again or select Pinned again on the pop-up
menu to hide the title bar.</p></li></ol>
<br><A NAME="TI542"></A><p>After you display a title bar either temporarily or permanently,
you can use the title bar's pop-up menu.</p>
<A NAME="TI543"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To maximize a pane to fill the workspace:</p>
<ol><li class=fi><p>Select Maximize from the title bar's
pop-up menu or click the Maximize button on the title bar</p></li></ol>
<br><A NAME="TI544"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To restore a pane to its original size:</p>
<ol><li class=fi><p>Select Restore from the title bar's
pop-up menu or click the Restore button on the title bar</p></li></ol>
<br><A NAME="CAIECHGH"></A><h3>Moving and resizing panes and views</h3>
<A NAME="TI545"></A><p>You can move a pane or a view to any
location in the painter window. You might find it takes a while
to get used to moving panes and views around, but if you do not
like a layout, you can always revert to the default layout and start again.
To restore the default layout, select View&gt;Layouts&gt;Default.</p>
<A NAME="TI546"></A><p>To move a pane, select and drag the title bar of the view
that is at the top of the stack. If the pane contains stacked views, <i>all</i> views
in the stack move together. To move one of the views out of the
stack, drag the tab for the view you want to move.</p>
<A NAME="TI547"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To move a pane:</p>
<ol><li class=fi><p>Place the pointer anywhere on the title
bar of the view at the top of the stack, hold down the left mouse
button, and start moving the pane.</p><p>A gray outline appears around the pane:</p><br><img src="images/ui15.gif"><br>
</li>
<li class=ds><p>Drag the outline to the new location.</p><p>The outline changes size as you drag it. When the pointer
is over the middle of a pane, the outline fills the pane. As you
drag the pointer toward any border, the outline becomes a narrow
rectangle adjacent to that border. When the pointer is over a splitter
bar between two panes, rows, or columns, the outline straddles the
splitter bar:</p><br><img src="images/ui16.gif"><br>
<p><img src="images/note.gif" width=17 height=17 border=0 align="bottom" alt="Note"> <span class=shaded>When you move the pointer to a corner</span> <A NAME="TI548"></A>When you move the pointer to a corner, you will find that
you have many places where you can drop the outline. To see your
options, move the pointer around in all directions in the corner
and see where the outline displays as you move it.</p>
</li>
<li class=ds><p>Release the mouse button to drop the outline in
the new location:</p><A NAME="TI549"></A><table cellspacing=0 cellpadding=6 border=1 frame="void" rules="all"><tr><th  rowspan="1"  ><A NAME="TI550"></A>To move a pane here</th>
<th  rowspan="1"  ><A NAME="TI551"></A>Drop the outline here</th>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI552"></A>Between two panes</td>
<td  rowspan="1"  ><A NAME="TI553"></A>On the splitter bar between the panes</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI554"></A>Between a border and a pane</td>
<td  rowspan="1"  ><A NAME="TI555"></A>At the side of the pane nearest the border</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI556"></A>Into a new row</td>
<td  rowspan="1"  ><A NAME="TI557"></A>On the splitter bar between two rows
or at the top or bottom of the painter window</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI558"></A>Into a new column</td>
<td  rowspan="1"  ><A NAME="TI559"></A>On the splitter bar between two columns
or at the left or right edge of the painter window</td>
</tr>
<tr><td  rowspan="1"  ><A NAME="TI560"></A>Onto a stack of panes</td>
<td  rowspan="1"  ><A NAME="TI561"></A>On the middle of the pane (if the pane
was not already tabbed, tabs are created)</td>
</tr>
</table>
</li></ol>
<br><A NAME="TI562"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To move a view in a stacked pane:</p>
<ol><li class=fi><p>Place the pointer anywhere on the view's
tab, hold down the left mouse button, and start moving the view.</p><p>You can now move the view as in the previous procedure. If
you want to rearrange the views in a pane, you can drag the view
to the left or right within the same pane. </p></li></ol>
<br><A NAME="TI563"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To resize a pane:</p>
<ol><li class=fi><p>Drag the splitter bars between panes.</p></li></ol>
<br><A NAME="CHDBDDHF"></A><h3>Floating and docking views</h3>
<A NAME="TI564"></A><p>Panes are docked by default within a
painter window, but some tasks may be easier if you float a pane.
A floating pane can be moved outside the painter's window
or even outside the PowerBuilder window.</p>
<p><img src="images/note.gif" width=17 height=17 border=0 align="bottom" alt="Note"> <span class=shaded>When you open another painter</span> <A NAME="TI565"></A>If you have a floating pane in a painter and then open another
painter, the floating pane temporarily disappears. It reappears
when the original painter is selected.</p>
<A NAME="TI566"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To float a view in its own pane:</p>
<ol><li class=fi><p>Select Float from the title bar's
pop-up menu.</p></li></ol>
<br><A NAME="TI567"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To float a view in a stacked pane:</p>
<ol><li class=fi><p>Select Float from the tab's pop-up
menu.</p></li></ol>
<br><A NAME="TI568"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To dock a floating view:</p>
<ol><li class=fi><p>Select Dock from the title bar's
pop-up menu.</p></li></ol>
<br><A NAME="CAIDADJJ"></A><h3>Adding and removing views</h3>
<A NAME="TI569"></A><p>You may want to add additional views to the painter window.
You can open only one instance of some views, but you can open as
many instances as you need of others, such as the Script view. If
there are some views you rarely use, you can move them into a stacked
pane or remove them. When removing a view in a stacked pane, make
sure you remove the view and not the pane.</p>
<A NAME="TI570"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To add a new view to the painter window:</p>
<ol><li class=fi><p>Select View from the menu bar and then
select the view you want to add.</p><p>The view displays in a new pane in a new row.</p></li>
<li class=ds><p>Move the pane where you want it.</p><p>For how to move panes, see <A HREF="pbugp18.htm#CAIECHGH">"Moving and resizing panes
and views"</A>.</p></li></ol>
<br><A NAME="TI571"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To remove a view in its own pane from the painter
window:</p>
<ol><li class=fi><p>If the view's title bar is not
displayed, display it by placing the pointer on the splitter bar
at the top of the pane.</p></li>
<li class=ds><p>Click the Close button on the title bar.</p></li></ol>
<br><A NAME="TI572"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To remove a view in a stacked pane from the painter
window:</p>
<ol><li class=fi><p>Select the tab for the view and select
Close from its pop-up menu.</p></li></ol>
<br><A NAME="TI573"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To remove a stacked pane from the painter window:</p>
<ol><li class=fi><p>If the title bar of the top view in the
stack is not displayed, display it by placing the pointer on the
splitter bar at the top of the pane.</p></li>
<li class=ds><p>Click the Close button on the title bar.</p></li></ol>
<br><A NAME="CAIDGHFH"></A><h3>Saving a layout</h3>
<A NAME="TI574"></A><p>When you have rearranged panes
in the painter window, PowerBuilder saves the layout in the registry.
The next time you open the painter window, your last layout displays.
You can also save customized layouts so that you can switch from
one to another for different kinds of activities.</p>
<A NAME="TI575"></A><p><img src="images/proc.gif" width=17 height=17 border=0 align="bottom" alt="Steps"> To save customized layouts for a painter window:</p>
<ol><li class=fi><p>Select View&gt;Layouts&gt;Manage
from the menu bar.</p></li>
<li class=ds><p>Click the New Layout button (second from the left
at the top of the dialog box).</p><br><img src="images/cust02.gif"><br>
</li>
<li class=ds><p>Type an appropriate name in the text box and click
OK.</p></li></ol>
<br><A NAME="TI576"></A><p>You can restore the default
layout at any time by selecting View&gt;Layout&gt;Default.</p>

